home *** CD-ROM | disk | FTP | other *** search
/ Software Explosion / Software Explosion (Fore-Matt Home Computing)(1996).iso / system / c / runit.doc < prev    next >
Text File  |  1994-01-01  |  13KB  |  314 lines
  1. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  2. %          RunIt version 1.6          %
  3. %       Updated: 11th July 1993       %
  4. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  5.  
  6. %%%%%%%%%
  7. % NOTE: %
  8. %%%%%%%%%
  9.  
  10.  Just a short note about version 1.5 which is a "butchered" 1.4 with
  11.  a BORDER option added , it was released by Thomas!/SP  NOT me!, the
  12.  routine he added did not work correctly with the Degrade and Scrblank
  13.  routines and caused the machine to GURU.
  14.  
  15.  I was *VERY* annoyed to see that someone had altered Version 1.4 and
  16.  added an option without even consulting me , in fact BORDER was already
  17.  due to be added! , the BORDER option ive coded for this version WORKS with
  18.  ALL options available on the RunIt command line!.
  19.  
  20.  Next time , if anyone wants an option added , just call The Krypt
  21.  and leave mail to me , or get a message to someone who DOES call the
  22.  Krypt , and they will pass the message on!.
  23.  
  24.  Its that simple.
  25.  
  26. %%%%%%%%%%%%%%%%%%
  27. % Future Options %
  28. %%%%%%%%%%%%%%%%%%
  29.  
  30.  I will be doing updates to RunIt every 3-4 weeks or so.
  31.  Version 1.7 is already being coded with a few newboot options
  32.  + an option that will allow you to use Runits "options" on
  33.  100% full dos disks!
  34.  
  35.  I will hopefully be adding a GUI version of Runit in future archives
  36.  
  37. %%%%%%%%%%
  38. % About: %
  39. %%%%%%%%%%
  40.  
  41.  Runit must NOT be distributed without this document file.
  42.  
  43.  Runit is charityware, if you use it, please give help to those in need.
  44.  
  45.  If you have any questions or ideas for more utils Call
  46.  
  47.  The Krypt BBS (UK) on 021 789 6845   (Oversea`s +44 21 789 6845)
  48.  
  49. %%%%%%%%%%
  50. % Usage: %
  51. %%%%%%%%%%
  52.  
  53.  Runit can be used in the startup-sequence as a cli command or used
  54.  from the cli/shell as a tool to run game/utility boot blocks that
  55.  refuse to work on 680x0 or newer machines such as A1200/4000/3000
  56.  
  57.  Tested on kickstarts 1.2 to 4.x ,and should work on all future kicks
  58.  
  59.  Runit with no options will display a help screen explaining the
  60.  options available, i will describe here in what circumstances
  61.  they may need to be used.
  62.  
  63.  It does not matter what order you type the options in.
  64.  
  65.  
  66. --------------------------------------------------------------------------- 
  67.  NOCACHE   - Use this option if diskloads fail, graphics corrupt
  68.              or if programs crash for no reason
  69. ---------------------------------------------------------------------------
  70.  SCRBLANK  - Have you ever noticed how using the boot options 
  71.              screen sometimes cause`s screens to be corrupted?
  72.              or when software that ran from workbench on kick 1.X
  73.              has corrupted screens on kick 2.X / 3.X.
  74.  
  75.              Also use this option if the colours appear wrong
  76.              when running the game on your AGA or AAA machine!
  77.  
  78.              This option opens a Fake 1.X screen and blanks it until
  79.              the software in question opens its own.
  80. ---------------------------------------------------------------------------
  81.  SPRITE    - If your sprites are corrupt / to large / small use this 
  82.              option to reset them to normal resolution
  83. ---------------------------------------------------------------------------
  84.  FAKEFAST  - An enhanced version of FAKEMEM , this will give you
  85.              512k chip / rest of chip ram: classed as fast ram: on
  86.              1meg + chip machines.
  87.  
  88.              Use this when "no fast mem" requesters appear , or when
  89.              games just lock , due to no fast mem.
  90.  
  91.              Remember this resets the machine the first time it is run
  92.              so any other options on the command line will be ignored
  93.              first time , but will function correctly next time they
  94.              are called.
  95. ---------------------------------------------------------------------------
  96.  NTSCMODE -  Ever noticed that annoying gap at the bottom of some
  97.              softwares screens , try this option! 
  98.              ECS chipset or above needed.
  99. ---------------------------------------------------------------------------
  100.  PALMODE  -  Returns you to normal screen mode    
  101.              ECS chipset or above needed.
  102. ---------------------------------------------------------------------------
  103.  OLDKICK  -  Because of certain changes in kick 2.X , 3.X , certain
  104.              games failed when libraries returns were slightly
  105.              different to those on kick 1.x , this routine patches
  106.              these to return old 1.x values.
  107.              Try these on games such as Silkworm IV , Saint Dragon ETC.
  108. ---------------------------------------------------------------------------            
  109.  SET???   -  This needs some explaining , what it does is to select the 
  110.              chipset you specify , if that chipset is available , or can be
  111.              Mimic`d then the system / hardware is told to use that chipset.
  112.              Currently AGA can mimic the OLD & ECS chipsets, use this option
  113.              when GFX / Sound corrupt etc.
  114.  
  115.              You could also use this option under AGA to speed up GFX 
  116.              routines that use the operating system. ( Use SETAGA )
  117.  
  118.              SETOLD  = Select/Mimic OLD chipset
  119.              SETECS  = Select/Mimic ECS chipset
  120.              SETAGA  = Select/Mimic AGA chipset
  121.              SETBEST = Use the best chipset available
  122. ---------------------------------------------------------------------------
  123.  VBASE    -  Use this option if games fail to load , no music etc.
  124. ---------------------------------------------------------------------------
  125.  NEWVBASE -  I have noticed that some games put code around the $c0 
  126.              memory area , while this is ok for the majority of games
  127.              that disable the operating system , it will cause a lot
  128.              of problems for HD installable software that does not!
  129.              Use this option if for NO reason a game locks up or fails
  130.              to function correctly on your 680x0 machine, but works fine
  131.              on a 68000 based one!
  132. ---------------------------------------------------------------------------
  133.  CHIP512K -  Many programs fail when more than 512k chip memory is 
  134.              available , especially demos , try this option if a game
  135.              or demo/etc fails to load on your 1meg+ chip machine
  136. ---------------------------------------------------------------------------
  137.  FASTOFF  -  Its stupid isnt it! , ive seen some NEW programs that have 
  138.              been written for the A1200/A4000 that HATE fastram when 
  139.              present and just lock up when its around!, try this option 
  140.              if all else fails!
  141. ---------------------------------------------------------------------------
  142.  BORDER   -  This routine is for those BADLY written intuition programs
  143.              that cause problems in certain screen modes / monitors.
  144.              These problems only occur on kick 3.X / 4.X machines.
  145.              There are no hard fast rules about this option , you could
  146.              just use it to improve clarity on your WB!.
  147.              
  148.              It will create a Black border around the screen area on 1st
  149.              running , run it again to return to normal screen mode!
  150.              
  151.              See NOTE: at beginning of this doc file!
  152. --------------------------------------------------------------------------
  153.  DEGRADE  -  A lot of people asked for this, what it does is basically
  154.              calls the nocache/scrblank/sprite/oldkick/setold/vbase
  155.              routines in this program, but all in one simple command!
  156.           
  157.              For those of you who are lazy or HATE typing :)
  158.  
  159.          Use this option if you are unsure why the software crashes
  160.           
  161.              NOTE: You can still add other options on the command line.
  162. ---------------------------------------------------------------------------
  163.  CLEAR    -  Resets machine if Virus or other contamination present.
  164. ---------------------------------------------------------------------------
  165.  FILTER   -  Turns off the low pass filter , this will make sounds
  166.              clearer and sharper.
  167. ---------------------------------------------------------------------------
  168.  HIGHBOOT -  Runit was originally written only as a cli command , but
  169.  LOWBOOT     its options were also usefull for NONDOS disks ie: games.
  170.              I found the boot options screen did not help all the time.
  171.              These 2 options were added so that a disk in df0: can be
  172.              booted with any of the options above.
  173. ---------------------------------------------------------------------------
  174.  
  175.  
  176.  Remember that runit can be used in a startup-sequence or used to boot
  177.  NON DOS disks , in this respect i think it is unique.
  178.  
  179. %%%%%%%%%%%%%%%%%
  180. % Some Examples %
  181. %%%%%%%%%%%%%%%%%
  182.  
  183.  You have installed a game from floppy on your HD,but when running
  184.  the games screens are corrupted,even though they ran ok from floppy
  185.  copy Runit to your hd,add these lines to the softwares startup-sequence
  186.  
  187.  Try : RunIt ScrBlank Sprite
  188.  Or  : RunIt ScrBlank Sprite SetOld
  189.  
  190.  
  191.  GFX & sprites / sound are corrupt
  192.  
  193.  Try : RunIt Nocache Sprite scrblank setold          
  194.  Or  : Runit Nocache Sprite scrblank setold Vbase
  195.  
  196.  
  197.  Games memory reports fail and refuses to load ie: Silkworm (Nondos)
  198.  
  199.  Try : RunIt scrblank oldkick Highboot
  200.  Or  : RunIt scrblank oldkick Lowboot
  201.  
  202.   
  203.  If you are unsure why the game fails and is standard dos
  204.  Copy Runit to your disk,and add these lines to the startup-sequence
  205.  
  206.  Try: Runit Degrade 
  207.  Or : Runit Degrade Fakefast
  208.  
  209.  If it is NONDOS ie: No files , can not be dir`ed
  210.  
  211.  Try : RunIt Degrade Highboot
  212.  Or  : RunIt Degrade Lowboot
  213.  
  214.  
  215.  If it still fails to load , try a mixture of options!.
  216.  
  217.  Remember if the game is NONDOS use the HighBoot / LowBoot options
  218.  
  219.  If you can alter the startup sequence,copy runit to the disk and
  220.  insert the Runit command call + options in the startup-sequence!
  221.  
  222. %%%%%%%%%%%%
  223. % Reminder % 
  224. %%%%%%%%%%%%
  225.  
  226.  RunIt is charity ware , if you use it , give help to those in need , 
  227.  in whatever way you wish , whether it be putting money in collection tins
  228.  , or clothes to charity shops , etc.
  229.  
  230. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  231. % RunIts history - Versions 1.0 to 1.6 %
  232. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  233.  
  234.  V1.0a The Initial release
  235.  
  236. --------------------------------------------------------------------------
  237.  
  238.  V1.1a Bug fixed release
  239.  
  240.  Minor bug in the scrblank routines caused copper corruption / crashes
  241.  in certain circumstance`s , this has now been fixed.
  242.  
  243.  Recoded , now totaly pc relative
  244.  
  245. --------------------------------------------------------------------------
  246.  
  247.  V1.2 Added new options + colour :)
  248.  
  249.      OLDKICK option added , helps with software incompatability on 2.x ,
  250.              3.x Kickstarts
  251.      SET???  option added , select OLD / ECS / AGA or BEST chipsets 
  252.              helps with GFX bugs , etc
  253.      
  254.      Memory routines rewritten for future Kickstart compatabilty
  255.      
  256. --------------------------------------------------------------------------
  257.  
  258.  V1.3 added new option - Sprite & recoded scrblank routines
  259.  
  260.      SPRITE   option added , helps stop sprite corruption on AGA &
  261.               ECS chip based machines
  262.                            
  263.      SCRBLANK option has been re-written - its screen / chipregs
  264.               setup are now as close to 1.x as possible
  265.                      
  266. --------------------------------------------------------------------------
  267.  
  268.  V1.4 added two new options - Vbase and Degrade + scrblank recoded again!
  269.  
  270.      VBASE    option added,helps stop mysterious crashes etc
  271.      
  272.      DEGRADE  option added,combines all the options needed to get
  273.               those stubborn games to run in one command!
  274.              
  275.      SCRBLANK option altered to also reset colour selection reg in 
  276.               AGA to palette #1,stops the wrong colours appearing! 
  277.  
  278. --------------------------------------------------------------------------
  279.  
  280.  V1.5 - lets just ignore this one eh!-Butchered 1.4 version by THOMAS!/SP
  281.  
  282. --------------------------------------------------------------------------
  283.  
  284.  V1.6   A bug that crept into NTSCMODE & PALMODE from version 1.3 has 
  285.         been fixed!, In some circumstances they just failed to work!
  286.      
  287.      Added four new options Newvbase - Chip512k - Fastoff - Border
  288.       
  289.  
  290.      NEWVBASE  option added,helps stop crashing/lockups on software
  291.                thats puts code at lower memory areas that are usually
  292.                reserved for 680x0 vector
  293.                
  294.      CHIP512K  option added,Turns off all chip ram > 512k
  295.      
  296.      FASTOFF   options added,Turns off all fast ram
  297.      
  298.      BORDER    option added,colours border colour to 0 , toggle back
  299.                to normal screen mode by running again
  300.      
  301. %%%%%%%%%%%%%%%%%%%%%%%
  302. % Another reminder :) %
  303. %%%%%%%%%%%%%%%%%%%%%%%
  304.  
  305.  Remember , if you have any suggestions , or more ideas for utils call 
  306.  
  307.  The Krypt BBS on (UK) 021 789 6845  (Oversea`s +44 21 789 6845)
  308.  
  309.  Leave mail to  Software Solutions
  310.  
  311. %%%%%%%%%%%%%%%%%%%%%%%%
  312. % End of Document file %
  313. %%%%%%%%%%%%%%%%%%%%%%%%
  314.